{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Tutorial 1a - Optiland for Beginners"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "tags": [
     "nbsphinx-toctree"
    ]
   },
   "source": [
    "### May 2024"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This tutorial describes the basics of Optiland. In particular, the following topics are covered:\n",
    "\n",
    "- Basic lens entry\n",
    "- Material definition and selection\n",
    "- Aperture, field and wavelength selection\n",
    "- Drawing a lens in 2D and 3D"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "import numpy as np\n",
    "\n",
    "from optiland import optic"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Building a Lens - an Overview\n",
    "\n",
    " This shows the full code to generate a singlet lens. In the next section, we will go into each part of this code in more detail."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "singlet = optic.Optic()\n",
    "\n",
    "# define surfaces\n",
    "singlet.add_surface(index=0, radius=np.inf, thickness=np.inf)\n",
    "singlet.add_surface(index=1, radius=20, thickness=7, is_stop=True, material=\"N-SF11\")\n",
    "singlet.add_surface(index=2, radius=np.inf, thickness=18)\n",
    "singlet.add_surface(index=3)\n",
    "\n",
    "# define aperture\n",
    "singlet.set_aperture(aperture_type=\"EPD\", value=25)\n",
    "\n",
    "# define fields\n",
    "singlet.set_field_type(field_type=\"angle\")\n",
    "singlet.add_field(y=0)\n",
    "\n",
    "# define wavelengths\n",
    "singlet.add_wavelength(value=0.5, is_primary=True)\n",
    "\n",
    "# view in 3D - Note this opens a new window, but we add a photo below to\n",
    "# show the visualization\n",
    "singlet.draw3D()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<figure style=\"text-align: left;\">\n",
    "  <img src=\"../images/singlet.png\" alt=\"Singlet\" style=\"width: 500px;\">\n",
    "</figure>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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uQLOFdtu5IsVGRlp7tOwOfJDzR9s68XrZ914/awbr5914/UbOH2t1Bqx6IOIiIiIbAKDLRERERHZBAZbGlQuLi548MEH1S1ZH14/68brZ914/awbr595cPMYEREREdkErtgSERERkU1gsCUiIiIim8BgS0REREQ2gcGWiIiIiGwCgy0NuNzcXFx77bWIi4uDm5sbhg0bpnaGtrS0dHm/Xbt2YebMmXB1dVXTWZ555hmznTN19fjjj2PatGlwd3eHr69vj++Tn5+Ps846S71PcHAw/vrXv6KtrW3Iz5V69vLLLyM2Nlb9fE2ZMgWbNm0y9ylRD3799VcsXLhQTVOSaZdffvlll7fL/u4HHngAYWFh6vF0/vz5yMzMNNv5UldPPvkkJk2apKaVyuPgokWLcODAgS7v09TUhFtuuQUBAQHw9PTE+eefj+LiYrOds61jsKUBl56erkYTv/7669i7dy9eeOEFvPbaa/jb3/7WZdTgaaedhpiYGGzduhXPPvssHnroIbzxxhtmPXcykD9CLrzwQtx00009vr29vV2FWnm/devW4f3338d7772nfgGT+X3yySe47bbb1B+U27Ztw5gxY7BgwQKUlJSY+9Som/r6enV95A+Rnsgf/C+++KJ6DN24cSM8PDzUtZSwROa3atUqFVo3bNiAn376Ca2trep3m1xXo7/85S/4+uuv8emnn6r3P3LkCM477zyznrdNk3ZfRIPtmWee0cfFxZlef+WVV/R+fn765uZm03133XWXPjk52UxnSD1599139T4+Psfc/+233+odHR31RUVFpvteffVVvbe3d5drSuYxefJk/S233GJ6vb29XR8eHq5/8sknzXpe1Df5lbxkyRLT6zqdTh8aGqp/9tlnTfdVVVXpXVxc9B999JGZzpL6UlJSoq7jqlWrTNdLq9XqP/30U9P77N+/X73P+vXrzXimtosrtjQkqqur4e/vb3p9/fr1mDVrFpydnU33ySqEPIVTWVlpprOk/pLrN2rUKISEhHS5frISL6v0ZD6yii7PgshT1kaOjo7qdbluZD1ycnJQVFTU5Vr6+Pio0hJeS8v9XSeMv+/kZ1FWcTtfw5SUFERHR/MaDhIGWxp0WVlZeOmll3DDDTeY7pMH686hSBhfl7eRZeP1s1xlZWWqVKSn68NrY12M14vX0jpICd6f//xnTJ8+HSNH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",
      "text/plain": [
       "<Figure size 1000x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# view in 2D\n",
    "singlet.draw(num_rays=10)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "vscode": {
     "languageId": "plaintext"
    }
   },
   "source": [
    "## Defining a lens, in detail:\n",
    "\n",
    "### Create the optic:\n",
    "\n",
    "In Optiland, lenses are instances of the \"Optic\" class. The process for defining a lens starts with creating an empty \"Optic\" object as follows:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens = optic.Optic()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Add the object surface:\n",
    "\n",
    "We now want to populate the lens object with surfaces. Let's first add the object surface, which will be at infinity and will have a radius of infinity, i.e. it is a plane. We add the surface by calling the \"add_surface\" method. We must specify the index as 0 to indicate this is the first surface."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens.add_surface(index=0, radius=np.inf, thickness=np.inf)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Add a lens:\n",
    "\n",
    "Let's now add a singlet lens. The lens will be defined as follows:\n",
    "\n",
    "- Material: N-SF11\n",
    "- Thickness: 7 mm\n",
    "- Radius side 1: 20 mm\n",
    "- Radius side 2: infinity\n",
    "- Stop surface: 1\n",
    "\n",
    "Optiland defines lenses one surface at a time, so we define each side of the lens separately. The material always corresponds to the material after interaction with a surface (refraction or reflection). Likewise, the thickness corresponds to the thickness after the surface and it is positive for surfaces to the right. This also implies that we must define the distance from the second surface to the next surface, which we'll define as 18 mm.\n",
    "\n",
    "Note that we specify the indices of the two surfaces as 1 and 2, after we already specified the object plane with index 0. Also note that Optiland uses millimeters by default."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens.add_surface(index=1, thickness=7, radius=20, is_stop=True, material=\"N-SF11\")\n",
    "lens.add_surface(index=2, radius=np.inf, thickness=18)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Add image plane:\n",
    "\n",
    "Lastly, let's add the image plane. By default, the radius is infinity, so we can exclude it. We also can omit thickness, as there are no surfaces beyond the image. We need only to define the index, which is 3."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens.add_surface(index=3)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Define aperture:\n",
    "\n",
    "Now, we can define the aperture of the system. Let's choose entrance pupil diameter (EPD) as the aperture type with a value of 25 mm.\n",
    "\n",
    "The options for aperture type are:\n",
    "\n",
    "- 'EPD' - entrance pupil diameter\n",
    "- 'imageFNO' - image-space F-number\n",
    "- 'objectNA' - object-space numerical aperture\n",
    "- 'float_by_stop_size' - the aperture size _floats_ with the size of the stop _diameter_, which is defined by the `value` argument."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens.set_aperture(aperture_type=\"EPD\", value=25)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Define fields:\n",
    "\n",
    "Let's add the fields of the lens. We'll keep it simple and add a single field of type \"angle\" with a value of 0.\n",
    "\n",
    "The options for field types are:\n",
    "\n",
    "- 'angle' - the angle of the field in object space\n",
    "- 'object_height' - the height of the object\n",
    "- 'paraxial_image_height' - the image height of a paraxial chief ray"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens.set_field_type(field_type=\"angle\")\n",
    "lens.add_field(y=0)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Define wavelengths:\n",
    "\n",
    "Lastly, let's define the wavelengths of the system. We define a single wavelength at 0.5 µm."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens.add_wavelength(value=0.5, is_primary=True)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### View the lens:\n",
    "\n",
    "Let's view the lens in 2D. We can do this by calling the `draw` method.\n",
    "\n",
    "Note that you can also pass a `projection` argument, allowing you to plot in the `\"YZ\"` plane (default), `\"XZ\"` plane, or `\"XY\"` plane.\n",
    "\n",
    "The 2D visualization is now interactive! You can hover over surfaces, lenses, and ray bundles to get more information. You can also customize the look and feel of the plots using themes. See the gallery for an example of how to use themes."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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uQLOFdtu5IsVGRlp7tOwOfJDzR9s68XrZ914/awbr5914/UbOH2t1Bqx6IOIiIiIbAKDLRERERHZBAZbGlQuLi548MEH1S1ZH14/68brZ914/awbr595cPMYEREREdkErtgSERERkU1gsCUiIiIim8BgS0REREQ2gcGWiIiIiGwCgy0NuNzcXFx77bWIi4uDm5sbhg0bpnaGtrS0dHm/Xbt2YebMmXB1dVXTWZ555hmznTN19fjjj2PatGlwd3eHr69vj++Tn5+Ps846S71PcHAw/vrXv6KtrW3Iz5V69vLLLyM2Nlb9fE2ZMgWbNm0y9ylRD3799VcsXLhQTVOSaZdffvlll7fL/u4HHngAYWFh6vF0/vz5yMzMNNv5UldPPvkkJk2apKaVyuPgokWLcODAgS7v09TUhFtuuQUBAQHw9PTE+eefj+LiYrOds61jsKUBl56erkYTv/7669i7dy9eeOEFvPbaa/jb3/7WZdTgaaedhpiYGGzduhXPPvssHnroIbzxxhtmPXcykD9CLrzwQtx00009vr29vV2FWnm/devW4f3338d7772nfgGT+X3yySe47bbb1B+U27Ztw5gxY7BgwQKUlJSY+9Som/r6enV95A+Rnsgf/C+++KJ6DN24cSM8PDzUtZSwROa3atUqFVo3bNiAn376Ca2trep3m1xXo7/85S/4+uuv8emnn6r3P3LkCM477zyznrdNk3ZfRIPtmWee0cfFxZlef+WVV/R+fn765uZm03133XWXPjk52UxnSD1599139T4+Psfc/+233+odHR31RUVFpvteffVVvbe3d5drSuYxefJk/S233GJ6vb29XR8eHq5/8sknzXpe1Df5lbxkyRLT6zqdTh8aGqp/9tlnTfdVVVXpXVxc9B999JGZzpL6UlJSoq7jqlWrTNdLq9XqP/30U9P77N+/X73P+vXrzXimtosrtjQkqqur4e/vb3p9/fr1mDVrFpydnU33ySqEPIVTWVlpprOk/pLrN2rUKISEhHS5frISL6v0ZD6yii7PgshT1kaOjo7qdbluZD1ycnJQVFTU5Vr6+Pio0hJeS8v9XSeMv+/kZ1FWcTtfw5SUFERHR/MaDhIGWxp0WVlZeOmll3DDDTeY7pMH686hSBhfl7eRZeP1s1xlZWWqVKSn68NrY12M14vX0jpICd6f//xnTJ8+HSNH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",
      "text/plain": [
       "<Figure size 1000x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "lens.draw(num_rays=10)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "tags": [
     "nbsphinx-toctree"
    ]
   },
   "source": [
    "Finally, we view the lens in 3D using the \"draw3D\" function. Note that this opens a new window."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [],
   "source": [
    "lens.draw3D()"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": ".venv",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.13.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}
